Mathieu Desnouveaux

#API Days Paris 2024

Sketchnotes étiquetées avec #API Days Paris 2024

#AFUP Lorraine #API Days Paris 2024 #API platform con 2024 #Apéro agile #Apéro web #Forum PHP 2022 #Forum PHP 2023 #Forum PHP 2024
La sketchnote de la conférence 'Meeting or Missing Target' est une illustration colorée qui explore la durabilité dans le secteur technologique. En haut au centre, le titre 'Meeting or Missing Target' est affiché, avec le sous-titre 'Data Center, Hardware, AI, and Sustainability'. Sous le titre, une flèche horizontale illustre le modèle linéaire de consommation : 'Take', 'Make', 'Consume', 'Dispose'. Au centre, trois blocs blancs distincts représentent trois idées principales : 1. 'Sustainable Consumption' : Cette section propose des conseils pour une consommation durable, avec des bulles et des flèches indiquant des actions telles que 'Think Globally', 'Don't focus on carbon assessment only', 'Consider other things', 'Reuse', 'Material/Social', et 'Circular Economy'. 2. 'How Too' : Ce bloc met en avant les éléments clés à travers des cercles orange et bleus, soulignant l'importance de 'Compare', 'Be Proactive', et 'Evaluate'. 3. 'To Make Informed Decisions' : Cette section insiste sur l'utilisation des 'Right Metrics' et l'augmentation de la collecte de données pour définir des cibles précises et développer des métriques utiles. En bas, une phrase finale rappelle la nécessité de métriques pour aborder la durabilité.

Meeting or missing target

La sketchnote de la conférence "7 Key Lessons on Building Great REST APIs" par Vedran Cindrić présente une vue d'ensemble des meilleures pratiques pour concevoir des API REST efficaces. En haut à gauche, le titre "API Days Paris 2024" est affiché en lettres blanches sur fond rouge. Le titre de la conférence, "7 Key Lessons on Building Great REST APIs", est écrit en lettres orange et noires sur fond blanc. La sketchnote est organisée autour de sept blocs principaux, chacun représentant une leçon clé relié par une ligne pointillée : 1. Design : Ce bloc met en avant l'importance de la sémantique, des méthodes HTTP spécifiques, des codes de réponse clairs, et de la versioning précoce. 2. Sécurité : Ce bloc souligne l’utilisation de HTTPS, l'authentification rigoureuse, la validation des données, et la protection des données. 3. Performance : Ce bloc recommande la mise en cache, la pagination, et l'optimisation des performances de la base de données. 4. Documentation : Ce bloc conseille une documentation descriptive avec des exemples et l'utilisation de standards comme OpenAPI. 5. Adoption : Ce bloc propose de fournir un SDK, un support technique, et un portail développeur de qualité pour faciliter l'intégration. 6. Gouvernance : Ce bloc recommande de définir des standards, centraliser la versioning, et établir un processus de revue des API. 7. Monétisation : Ce bloc conseille de proposer un niveau gratuit, un support commercial, et des tarifs prévisibles pour monétiser les API. Chaque bloc est entouré d'un cadre rouge et contient des notes manuscrites détaillant les points clés de chaque leçon.

7 Key Lessons on Building Great REST APIs

La sketchnote de la conférence de Gregor Hohpe présente les idées clés pour créer des abstractions efficaces. En haut, le titre "API Days Paris 2024" est affiché, suivi du titre de la conférence "Build Abstractions, Not Illusions". La sketchnote est organisée autour de plusieurs points : Limites Technologiques : La technologie doit être poussée à ses limites, tout en respectant ses contraintes. Plateformes et Complexité : Construire une plateforme lorsque quelque chose devient complexe pour augmenter la réutilisation et la collaboration. Pyramide IT : La construction de la base est coûteuse, et une planification excessive peut nuire à l'innovation. Plateforme Partagée : Une plateforme partagée offre une base standardisée pour l'innovation. Abstraction vs Illusion : Créer des abstractions claires et nommer les choses par leurs usages pour éviter les illusions. En bas, une note rappelle l'importance d'être explicite.

Build Abstractions, Not Illusions

La sketchnote de la conférence de Jean-Baptiste Kempf explore l'importance de l'open source, en particulier avec l'IA. En haut à gauche, le titre "API Days Paris 2024" est affiché en lettres blanches sur fond rouge. Le titre de la conférence, "Why Open Source Matters... And Even More Now With AI", est écrit en lettres orange et noires sur fond blanc. La sketchnote est structurée autour de plusieurs blocs et annotations : The Cone Player : L'open source est décrit à travers l'exemple du "cone player", le surnom du lecteur multimédia VLC, créé par et pour la communauté, offrant un logiciel libre et ouvert. Analogie du Gâteau : L'open source est comparé à un gâteau où le boulanger fournit le gâteau (logiciel), la recette (code source), et les spécifications du four (plateforme). Capacités de l'Open Source : L'open source permet d'utiliser, d'étudier, de modifier et de partager le logiciel, avec accès à la documentation, au code, et aux paramètres. Importance pour l'IA : L'open source est crucial pour l'IA car l'IA est omniprésente et l'open source garantit la transparence et l'accessibilité technologique. Des flèches relient ces concepts pour montrer les relations et les similitudes entre eux.

Why Open Source Matters...

La sketchnote de la conférence de Ikenna Nwaiwu traite du problème de la dérive des spécifications OpenAPI. En haut à gauche, le titre "API Days Paris 2024" est affiché en lettres blanches sur fond rouge. Le titre de la conférence, "Tackling Open API Drift", est écrit en lettres orange et noires sur fond blanc. La sketchnote est structurée autour de plusieurs blocs et annotations : 1. Dérive des Spécifications OpenAPI : La dérive survient lorsque la documentation OpenAPI ne correspond pas au comportement des API, entraînant des erreurs comme des champs manquants ou des schémas incorrects. 2. Statistiques : * 75 % des endpoints ne sont pas conformes à la spécification OpenAPI. * 25 % des endpoints n'ont pas de documentation. 3. Solutions Proposées : * Générer une description OpenAPI à partir du code, une tâche difficile. * Générer du code à partir de la description OpenAPI, une solution à long terme. * Utiliser des tests proxy pour la validation. * Utiliser les données et le code existants pour lutter contre la dérive des spécifications OpenAPI. Des flèches et des annotations relient ces concepts pour montrer les relations et les solutions proposées.

Tackling Open API Drift

La sketchnote de la conférence de Maxim Danilov présente une perspective alternative sur la documentation des spécifications OpenAPI (OAS). En haut à gauche, le titre "API Days Paris 2024" est affiché en lettres blanches sur fond rouge. Le titre de la conférence, "An Alternative View on Open API Docs: Start Finally Doing It Right", est écrit en lettres orange et noires sur fond blanc. La sketchnote est structurée autour de plusieurs blocs et annotations : 1. Un bloc "Problèmes" avec les point suivant : - Les spécifications OpenAPI ne décrivent pas comment organiser ou découvrir la documentation. - La documentation est difficile à comprendre pour les humains et les ordinateurs. - Les tests de grandes spécifications OAS consomment beaucoup de ressources. - Plusieurs standards similaires existent en même temps. 2. Un bloc "Solutions Proposées" avec les points suivant : - Diviser et conquérir : Diviser la documentation en fichiers plus petits pour une meilleure lisibilité et une consommation réduite de ressources. - Utiliser la méthode option : Fournir de petits fichiers YAML. - Utiliser un service : Servir des fichiers YAML à partir de fichiers OAS plus grands. Des flèches relient ces concepts pour montrer les relations entre les problèmes et les solutions proposées.

An Alternative View on Open API Docs

La sketchnote de la conférence de Beppe Catanese présente sept règles pour créer des bibliothèques API conviviales pour les développeurs. En haut à gauche, le titre "API Days Paris 2024" est affiché en lettres blanches sur fond rouge. Le titre de la conférence, "7 Rules for Crafting Developer Friendly API Libraries", est écrit en lettres orange et noires sur fond blanc. La sketchnote est structurée autour de plusieurs blocs et annotations : 1. Pourquoi (Why) : * Atteindre les développeurs qui vont exploiter les API. * Mettre en place des abstractions. * Augmenter la productivité. 2. Règles : * Open API Driven : Passer du schéma au code pour éviter la duplication. * Idiomatic : Adopter les conventions de langage et les frameworks. * Release Note : Déclarer les changements importants. * Code Snippets : Fournir de bons exemples de code. * Reference Implementation : Offrir divers exemples complets de cas d'utilisation. * Deprecation Markers : Utiliser des marqueurs pour indiquer l'obsolescence. * Great Documentation : Prioriser les meilleures pratiques de documentation. Des flèches et des annotations relient ces concepts pour montrer les relations entre les différentes règles.

7 Rules for Crafting Developer Friendly API Libraries